THE LAB · A LINE EDITOR AND A FOLIO BOARD (EXPERIMENTAL)
========================================================

This has only just started. It's a lab, and it's here for fun, for anyone
curious about what a browser can do with music. Nothing in it is finished.
Try things, break things, see what happens. Everything runs in your own
browser, from these files. Best in Chrome or Edge on a computer.

A folio is a song written as a grid instead of recorded: each line is one
instrument, and the steps you light are when it plays. It's saved as a small
text file (.music.json).

  THE LINE EDITOR
    IN    your clicks, or a folio
    OUT   a folio (.music.json), or the chart as text

  THE FOLIO BOARD (a template: one board that reads a folio)
    IN    a folio
    OUT   a take: the board and its own sound, as an MP4 (or a WebM)

  THE PROCESS   write in the editor → SAVE FOLIO → LOAD FOLIO on the board
                → it plays every note itself, and each note moves one line
                of tiles at the moment it sounds → TAKE records it


WHAT'S INSIDE
-------------

  THE LINE EDITOR - experimental.html       opens with Takatum loaded; saves a folio (the code),
                                            or the loop as a WAV or M4A (the sound)
  Ink and Paper - plays a folio (Takatum loaded).html
  Takatum.music.json                        a folio, made in the editor


THREE STEPS
-----------

  1. Open "THE LINE EDITOR - experimental.html" and press Play. That's
     Takatum: 25 lines, 107 BPM, four bars.

  2. Change something: light a step (click a lit step on a ♪ line to move
     its note up), move the tempo, add a line, stack an effect. Name it and
     press SAVE FOLIO. A .music.json lands in your Downloads.

  3. Open "Ink and Paper - plays a folio (Takatum loaded).html", press
     LOAD FOLIO, choose your file, press Play. TAKE records it, 1 to 4
     loops, board and its own sound.


UNDER THE HOOD
--------------

  - The editor: 94 sounds, all synthesized with the Web Audio API (plucked
    strings from a Karplus-Strong buffer, bells, drums, weather, and 37 band
    voices), and 18 effects per line.
  - A folio is JSON: tempo, meter, bars, and lines of {sound, deg (the note,
    0-8 on a Hirajoshi scale in D), vol, pan, fx, cells}.
  - The board: a chart and a scheduler. Every lit cell sounds and moves one
    line of tiles at the same audio time. Pitched notes slide the row of
    their pitch; each drum or effect has a row or a column of its own.

WHERE IT STANDS FOR NOW
-----------------------

  Only this board reads folios so far. It plays the notes but leaves out the
  editor's volumes, pans and effects, and it knows the editor's first 57
  sounds (the 37 band voices at the end of the list play in the editor only,
  for now). Use it as a template: ask your AI to give another board the same
  folio reader.

Made with Claude · by BeRogue · free to use and to learn from.
